home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 14 / CU Amiga Magazine's Super CD-ROM 14 (1997)(EMAP Images)(GB)(Track 1 of 3)[!][issue 1997-09].iso / CUCD / Utilities / Datatypes / PictureDT-V43 / Readme < prev   
Text File  |  1997-05-29  |  13KB  |  371 lines
  1.  
  2.                         picture.datatype V43
  3.                           Copyright 1995-97
  4.                            Ralph Schmidt
  5.            Additional libs/tools/changes by F.Mariak/M.Scheler
  6.            All sub datatypes by Matthias Scheler
  7.  
  8.  
  9. This  version is a freely available picture.datatype that MUST ONLY be used
  10. with  a  licenced  CyberGraphX(TM)  software  package  when using non 8 bit
  11. screenmodes. It also works with the recently released V3 version of
  12. CyberGraphX and you are allowed to use it with this also.
  13. You aren't allowed to use this software with any non licenced CyberGraphX(TM)
  14. "emulation"  in these modes.
  15. Usage of any of the included sub datatype classes with picture.datatype v43
  16. clones needs permission from their respective authors.
  17.  
  18. THE DATE EXPIRATION CODE HAS BEEN REMOVED. IT DOES NOT EXPIRE AFTER 4MONTH
  19. ANYMORE.
  20.  
  21. cyberncg.library support for non CyberGraphX machines has been dropped.
  22.  
  23. ******************************************************************************
  24.  
  25. Reporting bugs:
  26.  
  27. If   you   find   any   bugs   in   this  software,  please  send  them  to
  28. cybergfx.dtbugs@vgr.com.   Since  this  software is unsupported, we make no
  29. guarantees  about  how  long  it will take to fix the bug, or if it will be
  30. fixed  at  all.   Bug fixes will be cheerfully accepted.  Please include as
  31. much detailed information as possible, including:
  32.  
  33.     1) the version numbers of the related libraries/datatypes you are
  34.        using
  35.     2) the data file that caused the bug (if its not too big)
  36.     3) the OS version and machine type you ran the program on
  37.  
  38. ******************************************************************************
  39.  
  40. #########################
  41. #                       #
  42. #Important Informations #
  43. #                       #
  44. #########################
  45.  
  46. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  47. IF YOU'RE USING THE APPS THAT ARE IN THE COMPATIBILITY LIST( CHECK OUT SOME
  48. LINES  BELOW)  YOU  HAVE  TO NAME YOUR APPLICATION EXACTLY LIKE IN THE LIST
  49. OTHERWISE WON'T RECOGNIZE IT.
  50. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  51.  
  52. The  Aminet  release  of the png.datatype supports the V43 picture.datatype
  53. but  because  of  a  late change to the API(DTA_ErrorLevel,DTA_ErrorNumber)
  54. these  don't  support  these  tags.   I  hope  that  the authors of these 2
  55. datatype update their datatypes in the next time.
  56.  The  tags  are VERY important in a low memory situation.
  57.  
  58.  A  V43  compatible tiff.datatype as well as an bmp.datatype have also been
  59. released so far.
  60.  
  61.  
  62. Problems
  63.  
  64. o PPaint doesn't load 24bit images. Well..PPaint checks the BMHD.depth of
  65.   the raw data for >8...too bad
  66.  
  67. o Picview outputs "not a standard bitmap or something like that". This
  68.   is caused by the cgfx "PLANESTOFAST" option.
  69.  
  70. The following functions aren't implemented yet.
  71.  
  72. o 24bit dithering to a very small depth planar bitmap may cause
  73.   "problems". No time to test this out.
  74. o Sorry...also no time(lazyness) to test out PixMap support. I hope
  75.   it works as defined.
  76. o Right now it also doesn't really care for Ham6/8 and Halfbright.
  77. o DTM_Print for truecolour pictures should differ the picture to 256 colours
  78.   and then print it.
  79. o Make a Gauge interface so it may be controlled by tags(but does that
  80.   really make sense ? imagine a gauge popping up when iprefs is loading
  81.   your background)
  82. o scrollable transparent picture handling should be improved.
  83.   Now it only switches back in nonmask mode.
  84. o ******* AMosaic crashes ******* in 16Bit mode...i don't know why
  85.   yet(it worked in that mode in summer of 95 ......).
  86.  
  87.  
  88. ############################################################################
  89.  
  90.  
  91. The jfif.datatype is using the "jpeg.codec"
  92.  
  93. The JPEG codec is Copyright © 1994 Christoph Feck, TowerSystems.
  94. All Rights Reserved.  It is based in part on the work of the
  95. Independent JPEG Group.
  96.  
  97. ############################################################################
  98.  
  99.  
  100.  
  101.  
  102. ****************************************************************************
  103.  
  104. ATTENTION:
  105.  
  106. YOU  NEED TO HAVE AT LEAST VERSION 40.66 OF CYBERGRAPHICS.LIBRARY INSTALLED
  107. TO  USE THIS RELEASE OF PICTURE.DATATYPE V43 IN CONJUNCTION WITH A GRAPHICS
  108. CARD !
  109.  
  110. IF YOU INSTALL THIS ARCHIVE ON A DRACO BASED SYSTEM PLEASE MAKE SURE NOT TO
  111. INSTALL THE CYBERGRAPHICS.LIBRARY COMING WITH THIS ARCHIVE !
  112.  
  113. ****************************************************************************
  114.  
  115. Release Notes 43.759
  116. ====================
  117.  
  118. V43.759
  119.  
  120.  o added DTM_OBTAINDRAWINFO and DTM_RELEASEDRAWINFO methods. This methods are
  121.    needed for the new v45 datatypes.library. The code of this methods is
  122.    loosely based on work of Roland Mainz (drawablepicdtc patch).
  123.    With the inclusion of this 2 methods, v43 picture.datatype does not
  124.    require the drawablepicdtc patch anymore. (DTM_DRAW was supported before
  125.    already). Both methods are added to the list of supported methods, too.
  126.    Please check out the latest datatypes.library v45 archive by Roland Mainz
  127.    to get information on how this methods are used.
  128.  o added DTM_DRAW to list of supported methods
  129.  o method DTM_DRAW never really worked in previous picture.datatype v43
  130.    releases because the width/height of the object was always calculated
  131.    wrong. Now fixed. 
  132.  
  133. Release Notes 43.758a
  134. =====================
  135.  
  136. PICDT43.lha V43.758a
  137.  
  138.  o fixed a problem with the JFIF descriptor being for the wrong jfif.datatype
  139.  
  140. ----------------------------------------------------------------------------
  141.  
  142. PCDT Prefs 43.4
  143.  
  144.  o PCDT now always opens on the default Publicscreen and pops the screen to
  145.    front if required
  146.  
  147. PCDT Prefs 43.3
  148.  
  149.  o PCDT now also works now when the v43 picture.datatype is actually not
  150.    running
  151.  
  152. PCDT Prefs 43.2 
  153.  
  154.  o changed preferences format with pcdt > rev 752
  155.  
  156. ----------------------------------------------------------------------------
  157.  
  158. picture.datatype V43.758
  159.  
  160.  o minor internal changes
  161.  o added additional $VER version tag to picture.datatype file
  162.  o modified PictureClassExt.h as proposed by Rolanz Mainz on the DataType
  163.    mailing list.
  164.  o the gif.datatype has been removed by the author's request. Reading and/or
  165.    writing of GIF images requires a license to use Unisys patented Lempel Ziv
  166.    Welch (LZW) data compression and decompression technology, including US
  167.    Patent No. 4,558,302 & foreign counterpart patents. Therefore the
  168.    gif.datatype has been removed from the PictDT43 archive so that it may be
  169.    uploaded to Aminet (for the CDROM).It is available as a seperate archive.
  170.  
  171. V43.757
  172.  
  173.  o fixes some trouble with crashes on certain machines
  174.  
  175. V43.755
  176.  
  177.  o new pcdt prefs program v43.3 included
  178.  o new sub classes included
  179.  o added stack swapping code to picture.datatype dispatcher in order to fix
  180.    stack overflow related problems with applications which do not allocate
  181.    enough stack space
  182.  
  183. V43.754
  184.  
  185.  o fixed some bugs in method DTM_DRAW
  186.  o fixed some problems in conjunction with halfbrite source data
  187.  o new gif.datatype 43.14 included
  188.  
  189. V43.753
  190.  
  191.  o new pcdt prefs program v43.2 included
  192.  o the preferences file now has moved to env:sys
  193.  o new gif.datatype 43.13 included which fixes some strange crash problems
  194.  o fixed some problems in conjunction with planar graphic formats which
  195.    occasionally led to strange looking mwb-patterns
  196.  
  197. V43.751
  198.  
  199.  o the public semaphore is now available even if the picture.datatype is
  200.    expunged. This fixes a severe crash when the library is expunged
  201.  
  202. V43.750
  203.  o fixed a BYTE-READ from $0 when non v43 compatible applications called the 
  204.    picture.datatype
  205.  
  206. V43.748
  207.  
  208.  o gtlayout.library included in this archive. (required for the prefs
  209.    program)
  210.  o The application list which contains all V43 compatible applications may
  211.    now be configured with a seperate prefs program.
  212.  o removed support for environment variable "cybergraphics/pcdt_dither"
  213.    Please use the supplied prefs program PCDT to change dither settings now
  214.  o the expiration time is now 4 month instead of 1 month. So users who
  215.    can not access the net but get the datatype from an aminet cd are able
  216.    to use the picture.datatype release  for a certain amount of time
  217.    until a new version is released on cd
  218.  o there is an installer script now for v43 datatype installation which
  219.    also includes a backup option
  220.  o Tower JPEG Codec Class included as seperate archive
  221.  o new gif.datatype sub class V43.12 included
  222.  
  223. V43.718
  224.  
  225.  o bug fix in conjunction with datatype objects which require
  226.    mask planes and use planar bitmaps
  227.  o API-Demo source for datatype to ppm conversion added
  228.  o new versions of sub datatypes included
  229.  
  230. V43.716
  231.  
  232.  o ENV: "cybergraphics/pcdt_dither"
  233.    0 == Floyd Dithering(Better,slower) (DEFAULT)
  234.    1 == Ordered Dithering(Faster,Not so good gfx quality)
  235.  
  236. V43.713
  237.  
  238.  o new cybergraphics.library prerelease included
  239.  o the picture.datatype now uses ordered dithering as default.
  240.    A switch to select between floyd or ordered may follow in the
  241.    future
  242.  o included a new cyberncg.library which fixes a problem with
  243.    transparent images
  244.  o added V43 compatible PCX sub datatype to archive
  245.  
  246. V43.695
  247.  
  248.  o now supports AGA/ECS machines with cyberncg.library included in this archive.
  249.  
  250. V43.684
  251.  
  252.  o some internal structures have changed. Please use the new
  253.    cybergraphics.library coming with this archive
  254.  o the picture.datatype expires after a few weeks now
  255.    (all pre release versions will do that in the future)
  256.  o fixed a problem in conjunction with PDTA_DestBitMap and
  257.    ODF_USEFRIENDBITMAP which caused twice freed BitMaps in
  258.    the past
  259.  
  260. V43.667
  261.  o Fixed a 24bit->8Bit(OldBitmap) Dither problem.
  262.    Was caused by a change of the CyberBitmap checking code.
  263.    This may be the problem some experienced with PPaint which
  264.    i don't have to test it out...
  265.  
  266. V43.658
  267.  o Fixed a MUI Pattern problem
  268.  o Added DTM_DRAW...not tested
  269.  
  270. V43.647
  271.  o Fixed the remap problem some people experienced
  272.  
  273. V43.629
  274.  o Finally fixed the mysterious crash bug.
  275.  
  276. V43.6xx
  277.  o Multiview cludge
  278.  o Smarter Monitor ID overruling
  279.  o Alphachannel support
  280.  o fixed PDTA_DestMode,MODE_V42 fallback..
  281.  o Added an internal V43 compatibility list with the current entries:
  282.     "« IPrefs »",
  283.     "multiview",
  284.     "amigaguide",
  285.     "amosaic",
  286.     "amosaic-as225",
  287.     "amosaic-amitcp",
  288.     "DirectoryOpus",
  289.         NULL
  290.  o Fixed Aspect=0 save problem
  291.  o smarter PDTA_UseFriendBitMap that only does something when needed
  292.  o Truecolour alphachannel mask generation activated...will be used
  293.    automaticly by OM_RENDER
  294.  o 8Bit transparent mask generation activated...will be used automaticly
  295.    by OM_RENDER
  296.  o Fixed V42 fallback mode mungwall problems with dithering..hopefully.
  297.  o OM_Render transparent special handling..see docs for more infos
  298.  o Subdatatype Error API improvement
  299.  o creating transparent mask without layout if needed
  300.  o Fixed long outstanding V42 fallback color problem bug visible with DirOpus and others.
  301.  
  302. V43.451
  303.  o Important!!!!!
  304.    Include Change
  305.    DTM_BLITPIXELARRAY -> DTM_WRITEPIXELARRAY
  306.  
  307.  o PDTA_DEST works now. This means if PDTA_DEST,MODE_V43 isn't set
  308.    by application programs, a slow old planar bitmap is returned to
  309.    not break old programs that can only handle that bitmap.
  310.    Sigh..i could add an application list that works bitmaps format
  311.    independent.
  312.    Only exception is IPrefs for now...it gets a chunky bitmap.
  313.  
  314.  o PDTA_UseFriendBitMap is implemented(Stuntzi)
  315.  
  316.  o PDTA_NumPixMapDir
  317.    DTM_CREATEPIXMAPDIR
  318.    DTM_FIRSTPIXMAPDIR
  319.    DTM_NEXTPIXMAPDIR
  320.    DTM_PREVPIXMAPDIR
  321.    DTM_BESTPIXMAPDIR
  322.  
  323.    added to support multi-volume gfx formats like TIFF.
  324.  
  325.  o DTM_READPIXELARRAY added to avoid the sub datatype data sharing
  326.    design problem of the picture.datatype. If you ask me i would
  327.    have disallowed any data sharing at all because it destroys the
  328.    meaning of OO.
  329.  
  330.  o GAUGE disabled...there should be GAUGE Method imho
  331.  
  332. V43.395
  333.  
  334.  o Added a cludge to avoid a BestModeID crash
  335.  o Added a Volume Gauge...will be configurable in the future
  336.  o ilbm.datatype that handles 24bit...thanx Matthias
  337.  
  338. V43.352
  339.  
  340.  o Fixed a problem with WBPattern(not only this) and some pictures.
  341.    The reason was that BestCModeIDTagList() doesn't always work
  342.    and i had no fallback mode so the returned monitorid was INVALID.
  343.    This caused a lot problems..expecially the HAM/HALFBRIGHT bit test
  344.    on the modeid resulted into a wrong decision because INVALID=-1.
  345.  
  346. V43.340
  347.  
  348.  o DTM_PRINT added. It does nothing for 24Bit bitmaps.
  349.  
  350. V43.338
  351.  
  352.  o DTM_COPY added. It writes 8Bit and 24Bit output.
  353.  
  354. V43.335
  355.  
  356.  o DTM_WRITE added. It writes 8Bit and 24Bit output.
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364. Questions&Bugreports
  365. Don't expect fast response.
  366.  
  367. Ralfph Schmidt
  368. laire@popmail.owl.de
  369.  
  370.  
  371.